OptimizeBuffer(RasterCodecs,byte[],int,int,ImageOptimizerOptions,ImageOptimizerProgress) Method
Summary
Optimizes a supported image format buffer using the passed optimization options.
Syntax
Parameters
buffer
The original image buffer in memory as a System.Byte array. The image format in memory should be one of the following supported formats:
- RasterImageFormat.Jpeg, Bits per pixel: 8 for grayscale, 24 for color.
- RasterImageFormat.Jpeg411, Bits per pixel: 8 for grayscale, 24 for color.
- RasterImageFormat.Jpeg422, Bits per pixel: 8 for grayscale, 24 for color.
- RasterImageFormat.ExifJpeg411, Bits per pixel: 24 (color only).
- RasterImageFormat.ExifJpeg422, Bits per pixel: 24 (color only).
- RasterImageFormat.Gif, Bits per pixel: 1, 2, 3, 4, 5, 6, 7, and 8.
- RasterImageFormat.Png, Bits per pixel: 1, 4, 8, 24, 32, 48, and 64.
- RasterImageFormat.Bmp, Bits per pixel: 1, 4, 8, 16, 24, and 32.
- RasterImageFormat.BmpRle, Bits per pixel: 4, and 8.
offset
The number of bytes to offset the pointer that points to the buffer parameter" so that the data will be read starting from the "Buffer + Offset" position.
length
The length of the image buffer, in bytes, starting from the offset byte.
options
The options used in the optimization process.
progressCallback
Optional callback function that provides information about the progress of the optimization process.
Return Value
A System.Byte array that contains the optimized image buffer in memory.
Example
This example will optimize a Jpg image file then save it into a separate folder
using Leadtools;
using Leadtools.Codecs;
using Leadtools.ImageOptimization;
public void TestJpegImageOptimizer()
{
// Initialize the RasterCodecs class
RasterCodecs codecs = new RasterCodecs();
// The input and output location
string inputFileName = Path.Combine(LEAD_VARS.ImagesDir, "Cannon.jpg");
string outputFolder = Path.Combine(LEAD_VARS.ImagesDir, "OptimizedImages");
// Initialize a new Optimizer object
ImageOptimizer optimizer = new ImageOptimizer();
// Optimization Options
ImageOptimizerOptions options = ImageOptimizerOptions.Default;
// Set custom optimization options
options.JpegQualityFactor = 255;
options.JpegColorSpace = ImageOptimizerJpegColorSpace.JpegColorSpace422;
// Load the input file into a memory byte array
byte[] orgBuffer = File.ReadAllBytes(inputFileName);
// Optimize this buffer
byte[] optBuffer = optimizer.OptimizeBuffer(codecs, orgBuffer, 0, orgBuffer.Length, options, OptimizeBufferProgress);
// Save this image into the output folder
// Make sure the output folder exists
if (!Directory.Exists(outputFolder))
Directory.CreateDirectory(outputFolder);
// Get the name of the output file from the input file
string outputFileName = Path.Combine(outputFolder, Path.GetFileName(inputFileName));
// Save the optimized buffer to the output file
using (FileStream fs = File.Create(outputFileName))
fs.Write(optBuffer, 0, optBuffer.Length);
// Compare the original image size with the optimized size
long orgSize = new FileInfo(inputFileName).Length;
long optSize = new FileInfo(outputFileName).Length;
int percentage = (int)((double)optSize * 100.0 / orgSize);
string message = string.Format(
"Original image size: {0} KB{1}Optimized image size: {2} KB{1}Percentage: {3}%",
orgSize / 1024, Environment.NewLine, optSize / 1024,
100 - percentage);
MessageBox.Show(message);
//shutdown the RasterCodecs class.
}
static bool OptimizeBufferProgress(int percent)
{
Console.WriteLine(string.Format("{0}%", percent));
return true;
}
static class LEAD_VARS
{
public const string ImagesDir = @"C:\LEADTOOLS21\Resources\Images";
}
Imports Leadtools
Imports Leadtools.Codecs
Imports Leadtools.ImageOptimization
'''Imports Leadtools.Support.Examples
Public Sub TestJpegImageOptimizer()
' Initialize the RasterCodecs class
Dim codecs As RasterCodecs = New RasterCodecs()
' The input and output location
Dim inputFileName As String = Path.Combine(LEAD_VARS.ImagesDir, "Cannon.jpg")
Dim outputFolder As String = Path.Combine(LEAD_VARS.ImagesDir, "OptimizedImages")
' Initialize a new Optimizer object
Dim optimizer As ImageOptimizer = New ImageOptimizer()
' Optimization Options
Dim options As ImageOptimizerOptions = ImageOptimizerOptions.Default
' Set custom optimization options
options.JpegQualityFactor = 255
options.JpegColorSpace = ImageOptimizerJpegColorSpace.JpegColorSpace422
' Load the input file into a memory byte array
Dim orgBuffer() As Byte = File.ReadAllBytes(inputFileName)
' Optimize this buffer
Dim optBuffer() As Byte = optimizer.OptimizeBuffer(codecs, orgBuffer, 0, orgBuffer.Length, options, AddressOf OptimizeBufferProgress)
' Save this image into the output folder
' Make sure the output folder exists
If (Not Directory.Exists(outputFolder)) Then
Directory.CreateDirectory(outputFolder)
End If
' Get the name of the output file from the input file
Dim outputFileName As String = Path.Combine(outputFolder, Path.GetFileName(inputFileName))
' Save the optimized buffer to the output file
Using fs As FileStream = File.Create(outputFileName)
fs.Write(optBuffer, 0, optBuffer.Length)
End Using
' Compare the original image size with the optimized size
Dim orgSize As Long = New FileInfo(inputFileName).Length
Dim optSize As Long = New FileInfo(outputFileName).Length
Dim percentage As Integer = CType(CType(optSize * 100.0 / orgSize, Double), Integer)
Dim message As String = String.Format(
"Original image size: {0} KB{1}Optimized image size: {2} KB{1}Percentage: {3}%",
orgSize / 1024, Environment.NewLine, optSize / 1024,
100 - percentage)
MessageBox.Show(message)
'shutdown the RasterCodecs class.
End Sub
Public Shared Function OptimizeBufferProgress(ByVal percent As Integer) As Boolean
'Console.WriteLine(String.Format("{0}%", percent))
Return True
End Function
Public NotInheritable Class LEAD_VARS
Public Const ImagesDir As String = "C:\LEADTOOLS21\Resources\Images"
End Class
